home *** CD-ROM | disk | FTP | other *** search
/ Power Programmierung / Power-Programmierung (Tewi)(1994).iso / mumps / install.doc < prev    next >
Text File  |  1989-03-24  |  13KB  |  327 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                            MICROMUMPS
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                        INSTALLATION MANUAL
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                             Version 5
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                   Division of Computer Science
  30.                     University of California
  31.                         Davis, CA  95616
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                          William Yaksick
  38.                        Richard F. Walters
  39.  
  40.  
  41.  
  42.                          December, 1986
  43.           
  44.                        (updated March 1989)
  45.                           (version 5.2 )
  46.                           (marked '***')
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                           Introduction
  69.  
  70. With the release of Version 5.0 of UCD MicroMUMPS,  documentation
  71. will refer only to the current versions running under MSDOS. Pre-
  72. vious versions of MicroMUMPS written for  CP/M  and  CP/M86  have
  73. been discontinued and are available only under special order. The
  74. current version should run equally well under  MSDOS  and  PCDOS,
  75. vesions 2.0 and later.
  76.  
  77.  
  78.                        Materials Included
  79.  
  80. MUMPS.EXE The Object code for running MUMPS.  The version  number
  81.      will  appear on the disk label as well as in an opening mes-
  82.      sage when MUMPS is executed.
  83.  
  84. SETGLOB.EXE An assembly language program used to initialize  glo-
  85.      bal data space on disk. (Default name: GLOBALS.DAT)             ***
  86.  
  87. SETMUMPS.EXE An assembly language  program  used  to  reconfigure
  88.      your MUMPS system.
  89.  
  90. SETROUT.EXE An asembly language program used to set up  the  rou-
  91.      tine directory file (default name: ROUTINES.RTN).               ***
  92.  
  93. GLOBALS.DAT An initial globals data file created by SETGLOB. This
  94.      file  is  for demonstration purposes only, since it is rela-
  95.      tively small in size and could not hold  large  global  data
  96.      files.  Please note that under no circumstances will File       ***
  97.      Manager run using this globals file.                            ***
  98.  
  99. ROUTINES.RTN The file that contains all MUMPS routines distribut-    ***
  100.      ed  with  this  release.  The  distribution  disk includes a
  101.      number of utility programs and some application  or  demons-
  102.      tration  routines  available at distribution time. Abstracts
  103.      defining these routines are  included  in  the  distribution
  104.      package. The specific routines may vary from time to time.
  105.  
  106. ERRORS.DAT The error message file used  to  provide  decoding  of
  107.      specific  errors  encountered  when running MUMPS. Note that
  108.      the MUMPS system can run without this file, giving the error
  109.      message  numbers  only  rather  than the complete message. A
  110.      listing of Error Messages is found at the end of  the  Users
  111.      Manual.  SETMUMPS  is  used to initialize the drive on which
  112.      ERRORS.DAT is located. Once defined, it  cannot  be  changed
  113.      during a single MUMPS session.
  114.  
  115. USER'S  MANUAL  A  manual  describing  MicroMUMPS  features   and
  116.      language  extensions and giving some suggestions for ways in
  117.      which this version of MUMPS can be  most  effectively  util-
  118.      ized.
  119.  
  120. UTILITY/PERCENTM MANUALS These  documents describe  the  routines
  121.      included on the distribution disk.
  122.  
  123. TEST/VALIDATION DIALOG The final attachment is  a  dialog  illus-
  124.      trating an actual session in MUMPS. It can be used to verify
  125.      that the program runs as it should. It also serves as an in-
  126.      troduction  to  the  MUMPS  language,  since  most  language
  127.      features are demonstrated in the dialog.
  128.  
  129.                              - 1 -
  130.  
  131.  
  132.                   System Requirements for MicroMUMPS
  133.  
  134. CPU Chip: Either 8086, 8088, or the compatible 80186,  80286,  or
  135.      80386 processors. If your system contains an 8087 processor,
  136.      it will  automatically  be  detected  and  utilized  by  Mi-
  137.      croMUMPS.
  138.  
  139. Operating System: For PCDOS, we recommend version 3.0 or more re-
  140.      cent,  and  MSDOS, version 3.1 or more recent. Some features
  141.      of MUMPS, including screen cursor addressing, will not func-
  142.      tion under earlier releases.
  143.  
  144. Memory: At least 128K of memory. Starting with Version  5.0,  Mi-
  145.      croMUMPS  will utilize all memory above the first 128K bytes
  146.      for routine buffering. It is also possible to use CONFIG.SYS
  147.      to  enlarge the number of buffers used by MSDOS (external to
  148.      MicroMUMPS), and this may improve  performance  of  globals,
  149.      although we have not yet experimented with this alternative.
  150.  
  151. Disks: At least one 360 KB disk, IBM PC 9-sector format. Two disks  
  152.      preferred.  Double-sided  disks will be sent unless otherwise
  153.      specified (see order form). A hard disk drive  is  desirable
  154.      for large applications.
  155.  
  156. The file containing global data (GLOBALS.DAT) is  a  B-Tree  file
  157. that  contains  non-printing,  non-ASCII characters. It cannot be
  158. printed using standard MSDOS print commands.
  159.  
  160. MUMPS routines are stored in the file  with  the  [default]  name
  161. ROUTINES.RTN. This file contains a B-Tree directory and cannot be    ***
  162. printed using standard  MSDOS  commands.  Special  functions  for
  163. loading  and  saving  ASCII  files  into and out of this file are
  164. described later in the manual.
  165.  
  166.  
  167.  
  168.                   Instructions for Installation
  169.  
  170. 1. Before using MicroMUMPS, it is wise to make a backup  copy  of
  171. the  distribution disk or disks. The disk may be copied using ei-
  172. ther the DISKCOPY program provided with MSDOS or  the  COPY  com-
  173. mand.  To  use DISKCOPY, refer to your MSDOS manual. To use COPY,
  174. assume the source disk is in A, the destination disk in B. Type
  175.  
  176.         COPY A:*.* B:/V
  177.  
  178. 2. Your distribution disk comes with a small GLOBALS.DAT file al-
  179. ready created. You will, however, need to generate a larger global
  180. file by running SETGLOB, specifying the disk  you  wish  the  new
  181. globals  file  to  be  installed  on  (there can be no file named
  182. identically to the globals file you are creating on that disk prior  ***
  183. to running SETGLOB), and the size in Kbytes of the file you desire 
  184. to create. The Utilities Manual describes and illustrates this process.
  185.  
  186. 3. Your distribution disk comes with a ROUTINES.RTN file already     ***
  187. created. If you wish to create new files for other groups of routines,
  188. you may run the program SETROUT to make such a file.  Instructions
  189. for running SETROUT are found in the Utilities Manual.  You do not 
  190. need to run this program unless you wish to create a complete new 
  191. file for storing routines. You may use the ZFETCH command to get 
  192. MUMPS routines stored in earlier *.MMP format, as described in the 
  193. User Manual.  ZFETCH will overwrite any routine of the same name  
  194. already present in the routines library.  Refer to the VIEW command  
  195. in the User Manual to obtain a listing of current routines.
  196.                              - 2 -
  197.  
  198. 4. Using a backup disk created in Step 1 above in A: type MUMPS,     ***
  199. thereby going into the MUMPS interpreter. When a prompt character
  200. ``>'' appears, you may begin to enter MUMPS commands.  
  201.  
  202. 5. Following the sequence illustrated in the accompanying Valida-
  203. tion  Dialog  listing, type in the underlined commands, and check
  204. that the responses you receive are similar to those in the  list-
  205. ing.
  206.  
  207. 6. If you wish to reconfigure the system, it is recommended  that
  208. you  run  SETMUMPS  on a separate copy of the MUMPS.EXE file, re-
  209. taining the original configuration on your  backup  disk.  Follow
  210. the  instructions given in the Utilities section of this documen-
  211. tation.
  212.  
  213. 7. If you encounter problems with this installation process,  get
  214. a  printout  describing the difficulties and mail the printout to
  215. the Division of Computer Science,  UC  Davis,  Davis,  CA  95616.
  216. Although  we  cannot provide complete support, we will help as we
  217. are able to, including replacing a defective disk if necessary.
  218.  
  219. The PCDOS operating systems, versions 2.0 and more recent, permit
  220. cursor  control on the screen via some control characters. To use
  221. this feature, however, it is  necessary  to  follow  instructions
  222. given  in  chapter  13 of the DOS manual to configure your system
  223. for this option.  The most important requirement is that you must
  224. have a file named CONFIG.SYS on the disk that you use to boot the
  225. system, and this disk must contain the line  DEVICE=ANSI.SYS.  If
  226. you  already  have  CONFIG.SYS  on your system disk, be sure that
  227. this line is in the file. If you do not, follow the  instructions
  228. listed below:
  229.  
  230.         COPY  CON:  CONFIG.SYS  <return>          
  231.     DEVICE=ANSI.SYS <return>         
  232.     ^Z (control-Z) <return>
  233.  
  234. This set of instructions creates the necessary file.  Then,  when
  235. you reboot the system, it is properly configured to permit you to
  236. use control character sequences for  cursor  control  and  screen
  237. oriented commands.
  238.  
  239. Once ANSI.SYS is included in the boot process, it is possible  to
  240. use  a series of ASCII characters. These characters are described
  241. in the DOS manual, table 13-9. In MUMPS, use the WRITE  *nn  form
  242. of  the  WRITE command to accomplish these functions. A few exam-
  243. ples are:
  244.  
  245.         *27,*91,*50 *74 ;clear screen         
  246.     *27,*91,*75  ;erase to  end  of line         
  247.     *27,*91,*lin,*";",*col,"H" ;cursor posi- tion to lin and col
  248.  
  249.                       IBM PC Communication
  250.  
  251. This new version of MUMPS has incorporated the remote  communica-
  252. tions  device as described in the documentation.  There are a few
  253. warnings to be aware of if it does not work  as  expected.  There
  254. are  also  some  inconsistencies within MSDOS that cause problems
  255. with the communications mode. We are continuing to work on  these
  256. problems,  but we would appreciate written documentation describ-
  257. ing known errors in use of this feature.
  258.  
  259.  
  260.                              - 3 -
  261.  
  262.  
  263.  
  264.    1.  The interpreter is set up for communication for the IBM PC
  265.    and uses its locations for the internal handling of the remote
  266.    device.  We have not tested all look-alikes, so  depending  on
  267.    their  compatibility,  slight  hardware  differences may cause
  268.    problems.
  269.  
  270.    2. Communications is set up for COM1.  If you want to use COM2
  271.    instead, you must redirect the output from COM1 to COM2 using
  272.    the MSDOS MODE command. 
  273.  
  274.    3.  Presently, when using the PC as  a  "dumb  terminal"  from
  275.    within  MUMPS  (with  control-G) communications are limited to
  276.    600 baud.  When used as a terminal at 1200 baud, the first two
  277.    characters  on  each line are lost because the screen takes so
  278.    long to scroll.  File transfers have been successfully done at
  279.    2400  baud using the TK* routines. 
  280.  
  281.    4.  The IBM PC hardware expects some handshaking signals  from
  282.    the  communication part.  If whatever device you're talking to
  283.    (modem, computer, etc.) doesn't raise data set ready (DSR, pin
  284.    6)  and clear to send (CTS, pin 5) when it is sent data termi-
  285.    nal ready (DTR, pin 20) and request to send (RTS, pin 4), then
  286.    nothing will happen.  You will have to fool the PC by connect-
  287.    ing pin 4 to 5 and also pin 6 to  20  on  the  connector  that
  288.    fastens to the back of the PC from the remote device.
  289.  
  290.    5. Occasionally, the fix in #4 above isn't always enough.   If
  291.    the first thing you do is to check the status of the port, the
  292.    PC always thinks something is there even though  there  isn't.
  293.    Then  the  machine waits forever trying to read something that
  294.    isn't there.  To solve this problem, after setting up the baud
  295.    rate, just copy a small file to the communications port before
  296.    going into MUMPS.  This seems to work.
  297.  
  298. So, to use the communication features of MUMPS, first set up  the
  299. baud rate and communication characteristics with the MODE command
  300. from DOS.  To set up COM1 at 600 baud, no parity,  8  data  bits,
  301. and 1 stop bit type the following command:
  302.  
  303.  
  304.  
  305.         A>MODE COM1:60,N,8,1<RET>
  306.  
  307.         COM1:  600,n,8,1,-
  308.  
  309.         A>
  310. For more information on the MODE command,  see  the  DOS  manual.
  311. Next,  to  insure  that  the  port  is ready to talk (see item #5
  312. above) copy a short file (SHORT.DAT in the example) to  the  com-
  313. munications part (COM1 in the example).
  314.  
  315.         A>COPY SHORT.DAT COM1<RET>
  316.                 1 File(s) copied
  317.  
  318.         A>
  319. Now you are ready to enter MUMPS and use  device  5,  the  remote
  320. communications device, or control-G to use the PC as a terminal.
  321.  
  322.  
  323.  
  324.                              - 4 -
  325.  
  326.  
  327.